home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 7 / Apprentice-Release7.iso / Environments / Clean 1.2.4 / Clean Help / Clean Help.rsrc / STR#_10004.txt < prev    next >
Encoding:
Text File  |  1997-06-20  |  7.0 KB  |  337 lines
  1. 
  2.  
  3. √±5. Installation
  4.  
  5. 
  6.  
  7. The Concurrent Clean System version 1.2 for the Macintosh runs on any
  8.  
  9. Mac with system 6.0 (or higher). Generated distributed Clean applications
  10.  
  11. need system 7.0 (or higher). The Clean application needs at least 1.2
  12.  
  13. megabytes, but 2.0 megabytes of free memory is recommended. For
  14.  
  15. sub-launching at least another 700 K is needed. So, in total we recommend
  16.  
  17. about 3 Mb of free memory for the use of the Concurrent Clean System.
  18.  
  19. 
  20.  
  21. The proper installation of the Concurrent Clean System, including all
  22.  
  23. libraries, example programs and documentation requires 7 Mb of free
  24.  
  25. hard disk space. When you don't have that much space left on your hard
  26.  
  27. disk leave out (some of) the example programs.
  28.  
  29. 
  30.  
  31. 
  32.  
  33. 
  34.  
  35. 
  36.  
  37. 
  38.  
  39. Files which are part of the 1.2 distribution on the Mac.
  40.  
  41. 
  42.  
  43. The Concurrent Clean version 1.2 distribution consists of the following
  44.  
  45. files and folders:
  46.  
  47. 
  48.  
  49. 
  50.  
  51. ‚Ä¢   Clean 1.2 (68k)
  52.  
  53. 
  54.  
  55. The Concurrent Clean Programming Development System for Mac 68k.
  56.  
  57. This application can also be used on Power Macintoshes to generate 68k
  58.  
  59. applications.
  60.  
  61. 
  62.  
  63. ‚Ä¢   Installation
  64.  
  65. 
  66.  
  67. A folder containing a ReadMe file and a special Clean module Install.icl that
  68.  
  69. forces the compilation of all I/O libraries of Concurrent Clean.
  70.  
  71. 
  72.  
  73. ‚Ä¢   Clean Help
  74.  
  75. 
  76.  
  77. The help file you are reading now that is used by the Concurrent Clean
  78.  
  79. System.
  80.  
  81. 
  82.  
  83. ‚Ä¢   StdEnv
  84.  
  85. 
  86.  
  87. A folder containing the arithmetic libraries needed to create applications.
  88.  
  89. This folder contains the .dcl and .icl files (see Files) of all predefined
  90.  
  91. functions for arithmetic (see the Concurrent Clean Reference Manual).
  92.  
  93. 
  94.  
  95. It furthermore contains the modules
  96.  
  97. 
  98.  
  99.      _library
  100.  
  101.      _startup,
  102.  
  103.     _system,
  104.  
  105.     _SystemArray
  106.  
  107.     _SystemEnum
  108.  
  109. 
  110.  
  111. used by the compiler or needed for the run-time support of the generated
  112.  
  113. Clean applications.
  114.  
  115. 
  116.  
  117. The .abc and .obj files generated from these modules have been put in a
  118.  
  119. subfolder called Clean System Files (see below). Never throw away the
  120.  
  121. .abc or .obj files present in this folder, because not all these files can be
  122.  
  123. regenerated by the Concurrent Clean System.
  124.  
  125. 
  126.  
  127. ‚Ä¢   IOInterface
  128.  
  129. 
  130.  
  131. A folder containing the I/O library that provides the compact and elegant
  132.  
  133. specification of I/O including features such as menus, dialogues, windows
  134.  
  135. and mouse handling (see the Clean 1.2 Reference Manual).
  136.  
  137. 
  138.  
  139. The general rule is that modules that begin with 'Std' contain library
  140.  
  141. functions to be used by Clean programmers and that all other modules
  142.  
  143. contain low-level support functions for internal use.
  144.  
  145. 
  146.  
  147. ‚Ä¢   MacInterface
  148.  
  149. 
  150.  
  151. A folder containing the functions that realize the interface with the
  152.  
  153. Macintosh toolbox. The functions defined in this folder are used by the IO
  154.  
  155. library and should not be addressed directly by the programmer.
  156.  
  157. 
  158.  
  159. ‚Ä¢   Small Demos
  160.  
  161. 
  162.  
  163. This folder contains a number of very tiny Clean programs.
  164.  
  165. 
  166.  
  167. ‚Ä¢   IO Demos
  168.  
  169. 
  170.  
  171. This folder contains a few more elaborate example programs consisting of
  172.  
  173. more than one module to show what kind of interactive applications can be
  174.  
  175. written in Clean.
  176.  
  177. 
  178.  
  179. ‚Ä¢   Preferences
  180.  
  181. 
  182.  
  183. A folder Preferences in your System Folder (when this folder does not
  184.  
  185. yet exist) in which the preference file "Clean Prefs" is created.
  186.  
  187. 
  188.  
  189. ‚Ä¢   Clean System Files
  190.  
  191. 
  192.  
  193. Such a folder will be created inside the folder where your Clean
  194.  
  195. implementation or definition modules reside. In this folder all intermediate
  196.  
  197. files are stored generated by the system during compilations.
  198.  
  199. 
  200.  
  201. 
  202.  
  203. Installing the Clean system
  204.  
  205. 
  206.  
  207. Make a back-up of your old Clean programs, Clean system and I/O
  208.  
  209. libraries. An old preference file will be removed automatically when you
  210.  
  211. start the Clean application.
  212.  
  213. 
  214.  
  215. Put the Clean 1.2 application, the Installation folder, the StdEnv folder,
  216.  
  217. the IOLibrary folder, the MacInterface folder, and the Clean Help file in
  218.  
  219. one folder on your Mac. Put the example programs in any folder you like.
  220.  
  221. Put related Clean programs (a Clean project) in one folder. The Clean 1.2
  222.  
  223. Ref Man folder put anywhere you like.
  224.  
  225. 
  226.  
  227. Clean 1.2 by default is set to require 2000 K. If your Mac has not enough
  228.  
  229. memory available, set this number lower (use Get Info) before you start
  230.  
  231. the application. You can try 1200 K for small examples, but 2000 K or
  232.  
  233. more is more likely to be needed when you are developing larger
  234.  
  235. applications. The linking phase requires a lot of memory, especially when
  236.  
  237. the I/O libraries have to be linked with a project. When the linker cannot
  238.  
  239. allocate the memory it needs inside the Clean 1.2 application it tries to
  240.  
  241. allocate free memory outside the application. When the memory of the
  242.  
  243. Clean 1.2 application is set to 2000K and the I/O libraries should be linked
  244.  
  245. to a project the linker needs about 700K of free memory outside the Clean
  246.  
  247. 1.2 application. The compilation of large applications requires a lot of
  248.  
  249. memory (in general 3 Mb will be enough).
  250.  
  251. 
  252.  
  253. The Concurrent Clean System generates Mac applications. If you have
  254.  
  255. Virus detectors they may complain about this. Clear the protection for the
  256.  
  257. Clean 1.2 application. The Clean 1.2 application should be allowed to
  258.  
  259. create, edit and delete other files (but not system files). Make sure that
  260.  
  261. you have an original unaffected Nijmegen version of the Clean System
  262.  
  263. (see availability).
  264.  
  265. 
  266.  
  267. Make sure that the following path names are set in the default paths
  268.  
  269. (choose Paths... in the Options menu) such that at least the following
  270.  
  271. standard Clean libraries can be found (assuming that the Clean 1.2
  272.  
  273. application and the libraries are put into one folder):
  274.  
  275. 
  276.  
  277.     {Application}:StdEnv:
  278.  
  279.     {Application}:IOLibrary:
  280.  
  281.     {Application}:MacInterface:
  282.  
  283. 
  284.  
  285. Pathnames that are printed in italics do not lead to the indicated libraries.
  286.  
  287. Remove these paths and add the missing libraries.
  288.  
  289. 
  290.  
  291. It is possible that you have received a version of the Clean System in
  292.  
  293. which the .obj and/or .abc files of the I/O and arithmetic libraries are not
  294.  
  295. present, for example to save disk space and/or copying time. Compilation
  296.  
  297. of a program using the I/O libraries may take a considerable amount of
  298.  
  299. time (up to 40 minutes on a Mac Plus) then, because code has to be
  300.  
  301. generated for all modules of these libraries. Fortunately this has to be
  302.  
  303. done only once, so the next time compilation will be much faster. To
  304.  
  305. completely compile the libraries the memory of the Clean 1.2 application
  306.  
  307. should be set to at least 2 Mb. The program Install.icl (folder Installation)
  308.  
  309. imports all libraries and therefore forces the compilation of these
  310.  
  311. libraries when it is compiled by the Clean system. So, to compile all
  312.  
  313. libraries once and for all open Install.icl and choose Bring Up To Date of
  314.  
  315. the Commands menu. The Clean System Files folder and the application
  316.  
  317. Install that will be generated inside the Installation folder can be thrown
  318.  
  319. away afterwards.
  320.  
  321. 
  322.  
  323. We have used the following convention when a Clean project consists of
  324.  
  325. more than one Clean module. The main module has been coloured red, the
  326.  
  327. other modules green (.icl files) and brown (.dcl files). If your Mac does
  328.  
  329. not display colours, the main module can always be recognized by the fact
  330.  
  331. that it has no corresponding definition module (.dcl file).
  332.  
  333. 
  334.  
  335. 
  336.  
  337.